home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmFontListEntryLoad.z / XmFontListEntryLoad
Text File  |  1998-10-30  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyLLLLooooaaaadddd((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyLLLLooooaaaadddd((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyLLLLooooaaaadddd - A font list function that loads a font
  10.           or creates a font set and creates an accompanying font list
  11.           entry
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           #include <Xm/Xm.h>
  15.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyy XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyLLLLooooaaaadddd(
  16.           DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,
  17.           cccchhhhaaaarrrr ****ffffoooonnnntttt____nnnnaaaammmmeeee,
  18.           XXXXmmmmFFFFoooonnnnttttTTTTyyyyppppeeee ttttyyyyppppeeee,
  19.           cccchhhhaaaarrrr ****ttttaaaagggg);
  20.  
  21.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  22.           This page documents Motif 2.1.
  23.  
  24.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyLLLLooooaaaadddd loads a font or creates a font set based
  26.           on the value of the _t_y_p_e argument. It creates and returns a
  27.           font list entry that contains the font or font set and the
  28.           specified tag.
  29.  
  30.           If the value of _t_y_p_e is XXXXmmmmFFFFOOOONNNNTTTT____IIIISSSS____FFFFOOOONNNNTTTT, the function uses
  31.           the XXXXttttCCCCvvvvttttSSSSttttrrrriiiinnnnggggTTTTooooFFFFoooonnnnttttSSSSttttrrrruuuucccctttt routine to convert the value of
  32.           _f_o_n_t__n_a_m_e to a font struct.  If the value of _t_y_p_e is
  33.           XXXXmmmmFFFFOOOONNNNTTTT____IIIISSSS____FFFFOOOONNNNTTTTSSSSEEEETTTT, the function uses the
  34.           XXXXttttCCCCvvvvttttSSSSttttrrrriiiinnnnggggTTTTooooFFFFoooonnnnttttSSSSeeeetttt converter to create a font set in the
  35.           current locale.  XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyLLLLooooaaaadddd creates a font list
  36.           entry that contains the font or font set derived from the
  37.           converter.  For more information about
  38.           XXXXttttCCCCvvvvttttSSSSttttrrrriiiinnnnggggTTTTooooFFFFoooonnnnttttSSSSttttrrrruuuucccctttt and XXXXttttCCCCvvvvttttSSSSttttrrrriiiinnnnggggTTTTooooFFFFoooonnnnttttSSSSeeeetttt, see _X
  39.           _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s-_C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e.
  40.  
  41.           _d_i_s_p_l_a_y   Specifies the display where the font list will be
  42.                     used.
  43.  
  44.           _f_o_n_t__n_a_m_e Specifies an X Logical Font Description (XLFD)
  45.                     string, which is interpreted either as a font name
  46.                     or as a base font name list.  A base font name
  47.                     list is a comma-separated and NULL-terminated
  48.                     string.
  49.  
  50.           _t_y_p_e      Specifies whether the _f_o_n_t__n_a_m_e argument refers to
  51.                     a font name or to a base font name list.  Valid
  52.                     values are XXXXmmmmFFFFOOOONNNNTTTT____IIIISSSS____FFFFOOOONNNNTTTT and XXXXmmmmFFFFOOOONNNNTTTT____IIIISSSS____FFFFOOOONNNNTTTTSSSSEEEETTTT.
  53.  
  54.           _t_a_g       Specifies the tag of the font list entry to be
  55.                     created.  The tag may be specified as
  56.                     XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG, which is used to identify
  57.                     the default font list element in a font list when
  58.                     specified as part of a resource.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyLLLLooooaaaadddd((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyLLLLooooaaaadddd((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      RRRREEEETTTTUUUURRRRNNNN
  75.           If the specified font is not found, or if the specified font
  76.           set cannot be created, then either an implementation-defined
  77.           font will be opened or a font set will be created, and a
  78.           warning messge will be generated. If no suitable font can be
  79.           found or a font set cannot be created, then another message
  80.           will be generated and the function will return NULL;
  81.           otherwise the function returns a font list entry.  If the
  82.           function returns a font list entry, the function allocates
  83.           space to hold the font list entry. The application is
  84.           responsible for managing the allocated space. The
  85.           application can recover the allocated space by calling
  86.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyFFFFrrrreeeeeeee.
  87.  
  88.      RRRREEEELLLLAAAATTTTEEEEDDDD
  89.           XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt(3), XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttAAAAppppppppeeeennnnddddEEEEnnnnttttrrrryyyy(3),
  90.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyCCCCrrrreeeeaaaatttteeee(3), XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyFFFFrrrreeeeeeee(3),
  91.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyGGGGeeeettttFFFFoooonnnntttt(3), XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttEEEEnnnnttttrrrryyyyGGGGeeeettttTTTTaaaagggg(3), and
  92.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttRRRReeeemmmmoooovvvveeeeEEEEnnnnttttrrrryyyy(3).
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.